home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 749 / paperback / paperback!.doc < prev    next >
Text File  |  1995-03-18  |  15KB  |  307 lines
  1.  
  2. ***************************************************************************
  3. *                                                                         *
  4. *                               PaperBack!                                *
  5. *                                                                         *
  6. *                               by BOB RYE                                *
  7. *                                                                         *
  8. *                     Public Release: Friday 24/09/1992                   *
  9. *                                                                         *
  10. ***************************************************************************
  11.  
  12. Everything contained in this release of PaperBack! for the Amiga is
  13. USE-AT-OWN-RISK. I, the author, make no guarantee as to the fitness for
  14. use of this software. I accept no responsibility for possible damages
  15. incurred before, during or after execution of this software.
  16.  
  17.  
  18.  #### #    #### #### #### ####   #### #### #### ###    ##### #  # # ####   #
  19.  #  # #    #    #  # #    #      #  # #    #  # #  #     #   #  # # #      #
  20.  #### #    ###  #### #### ###    #### ###  #### #  #     #   #### # ####   #
  21.  #    #    #    #  #    # #      # #  #    #  # #  #     #   #  # #    #
  22.  #    #### #### #  # #### ####   #  # #### #  # ###      #   #  # # ####   #
  23.  
  24. *****************************************************************************
  25.  
  26.                    DID YOU PAY MONEY FOR THIS SOFTWARE?
  27.  
  28.                           PaperBack! is FREEWARE
  29.  
  30.  This software is FREEWARE. This software is free. If you have paid
  31.  money for this software, then you have been ripped off. I have written
  32.  this program for you, for free. If you paid for "support" from where you
  33.  got this file, then you are also being ripped off. There is only one
  34.  person who is qualified to help you with the operation of this program:
  35.  ME (Bob Rye, the guy who wrote this program.)
  36.  
  37.  You cannot obtain support from some unqualified desk-doofus hiding behind
  38.  the facade of "a support specialist". All that these people are doing is
  39.  making money from you, the innocent end-user, and ripping me off by
  40.  immorally making money from *MY* programs.
  41.  
  42.  Please take a stand against these companies. Please don't buy *FREE*
  43.  software from these companies. If you would like copies of any (or all)
  44.  of MY software (anything by Bob Rye) you can have them for *FREE*. That's
  45.  right, for nothing. All I ask for is a blank disk, to copy the programs
  46.  onto, and the cost of return postage (and your address!) Then if you want
  47.  "support" for my programs, send Fido Netmail to me (addresses are at the
  48.  bottom of this document) or snail-mail me and you'll get real support.
  49.  
  50.                           STAND UP AND BE COUNTED.
  51.  
  52.                       Say NO! to costly FREE software.
  53.  
  54. *****************************************************************************
  55.  
  56. If you represent a PD/Shareware/Freeware library or electronic distribution
  57. system, then please feel free to contact me to gain written permission to
  58. allow you to legally include this software in your library, for
  59. distribution. The "ADS" electronic distribution system has my written
  60. permission to redistribute this software, as does Fred Fish.
  61.  
  62. You may copy and transfer copies of this package to whoever you like,
  63. provided that this package is transferred completely intact, with all
  64. documentation and executables unmodified therein (modification of
  65. copyrighted works is called "contributory copyright infringement" and
  66. persons found infringing copyright are liable to legal action); however,
  67. if you represent a registered (or otherwise) company, and you wish to
  68. redistribute this package, you MUST obtain my prior written permission.
  69. The copyright to PaperBack!, the documentation, the source-code, and the
  70. actual software remains the explicit property of Bob Rye, © 1992.
  71.  
  72. ANY commercial distribution of this package without the prior written
  73. consent of the author (Bob Rye) is expressly prohibited.
  74.  
  75. PaperBack! © BOB RYE (1988-1992 inclusive)
  76.  
  77.                                 DISCLAIMER
  78.                                 ----------
  79. ALTHOUGH OUTSTANDING BUGS IN THE CODE HAVE BEEN ELIMINATED, THERE REMAINS
  80. THE POSSIBILITY OF UNFORESEEN PROBLEMS. I RESERVE THE RIGHT TO REFUTE THE
  81. EXISTENCE OF SUCH 'BUGS', BUT IF FOUND, WE WILL ATTEMPT TO FIX SUCH
  82. PROBLEM(S). IF, HOWEVER, UNFORESEEN BUGS ARE FOUND TO CAUSE YOU MENTAL
  83. AND/OR PHYSICAL ANGUISH, THEN THAT IS AS THEY SAY IN THE CLASSICS, BAD
  84. LUCK! I ACCEPT NO BLAME FOR ANY LOSS OR INCONVENIENCE FOUND TO ARISE FROM
  85. THE (MIS)USAGE OF THIS PROGRAM. I RESERVE THE RIGHT TO WITHDRAW SUPPORT
  86. AND UPGRADES AT ANY TIME. I PROBABLY WON'T DO THIS, BUT I HAVE THIS RIGHT.
  87.  
  88.  
  89. ALL INSTANCES OF COMPANY AND/OR PRODUCT NAMES ARE (C), (R) AND (TM)
  90. RESPECTIVELY, WHERE APPLICABLE. "PaperBack!" IS COPYRIGHT BOB RYE,
  91. 1992.
  92.  
  93. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  94.                          ###### PaperBack! ######
  95.                          Version: 2.004 © Bob Rye
  96.                          Cmp 13:32:17 Sep 01 1992
  97.  
  98. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  99.  
  100.                                Introduction
  101.                                ------------
  102.     Once upon a time, I had a tractor feed printer.  This was fine for
  103. rough and ready hex dumps and writing silly messages to people, but
  104. otherwise, the ragged look of cheap tractor paper didn't make for a
  105. wonderful presentation.  Then I bought a single sheet feeder for my printer
  106. (a lovely little Star NX24-10) and started to buy single sheet paper.
  107. After a while, I started to realise that by only using one side of this
  108. paper for standard dumps I was being a little bit wasteful.  So then I
  109. started using both sides of my single sheet paper, and all was well in
  110. Ballarat.
  111.  
  112.     Then, out of nowhere, came the need to stack 20 or more sheets of paper
  113. into the sheet feeder and to print out huge documents. The question was
  114. posed: "How do I use both sides of the paper when I just dump the document
  115. to the printer?" This was a doosy. I then tried various commercial packages
  116. hoping that they would allow me to load a document file, separate the odd
  117. pages from the even, print the odd pages, and then print the evens on the
  118. back of the odds. Looking, looking, looking...
  119.  
  120.     I finally had a look at Excellence! because it apparently had alternate
  121. side printing. One thing I immediately noticed with Excellence! was it's
  122. slick appearance, and seemingly useful options. I was wrong. Wolf in
  123. sheep's clothing I'm afraid (IMO).  What a truly useless package!  It never
  124. printed anything out properly on my setup.  Several other people attempted
  125. the same thing, and failed.  It wasn't just me!  I somehow managed to get
  126. Excellence!  to think about alternately printing a document for me.
  127. Unfortunately, I didn't realise that Excellence!  is only for those of you
  128. with '040 accelerators, and it took about 10 minutes to load a 600k doc.
  129. Then the alternate printing started after I set it up.  What a laugh.  It
  130. printed page 3 first.  Then page 14.  Then a load a postscript.  Then
  131. binary garbage.  Then page 1.  I don't like Excellence!.  The problem was
  132. that Excellence!  was the only package I'd seen that would alternately
  133. print for you.  Until...
  134.  
  135. PaperBack V1.01
  136.  
  137. the assembly language beast. Pback version 1.01 worked beautifully if you
  138. treated it right, but bitched you to death if you didn't. You had to
  139. manually place the formfeeds (pagebreaks) into the documents BEFORE you let
  140. Pback print it. Pback 1.01 had to have a formfeed as the LAST character at
  141. the end of the file. If it didn't, Pback 1.01 would take your machine to
  142. the meditation room. PaperBack version 1.0a was written in November of
  143. 1989, and version 1.01 was written sometime in 1990. Up until now,
  144. PaperBack hasn't been updated. But now that I've got a mean-as-cats-piss C
  145. compiler, why not update the thing?
  146.  
  147.     Please note that PaperBack! DOES NOT print documents. It only
  148. pre-arranges the documents for better printing.
  149.  
  150.  
  151. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  152.  
  153.                                 Front Panel
  154.                                 -----------
  155.  
  156. ###### PaperBack! ######
  157. Version: 2.002 © Bob Rye
  158. Cmp 13:32:17 Sep 01 1992
  159.  
  160. Usage: PaperBack [-S] [-Fnnn] -iinfile [-ooutfile]
  161.  -S        = summary [no-action] mode
  162.  -Fnnn     = force a formfeed every nnn lines
  163.              [ default = 66 lines ]
  164.  -iinfile  = use file infile as source
  165.  -ooutfile = use file outfile as destination
  166.              [ default = infile.[odds|evns] ]
  167.  
  168.  
  169. The above is what you'll get if you enter "PaperBack! ?" from the CLI.
  170. This is the help screen, and PaperBack!  defaults to this screen if options
  171. are given in an incorrect way.  Let's explain the switches, which are, BTW,
  172. case-insensitive:
  173.  
  174. -S        - you should use this switch when you would like to know how many
  175.             pages the document contains, how many lines etc. The number of
  176.             pages figure is useful for when you intend to print the document
  177.             to your printed (just how many sheets do I need?) This summary
  178.             mode is a passive mode. Nothing actually changes during this
  179.             evocation. The only other switch which needs to be given in
  180.             conjunction with "-S" is the "-i" infile switch.
  181.  
  182.               Example: PaperBack! -s -ivd0:doc
  183.             will give you the summarised run-down on the contents of "doc".
  184.  
  185. -Fnnn     - this switch allows you to override previously set formfeed
  186.             locations throughout the document. If your document already
  187.             contains formfeeds/pagebreaks, but you'd like to discount them
  188.             because your printer settings allow you to stack 80 lines per
  189.             sheet (instead of 66 lines), then you can use this switch to
  190.             fully override the pre-existing formfeeds. The old formfeeds
  191.             will be skipped by PaperBack!, and only your preferred formfeed
  192.             settings will be accounted. If you use the "-F" switch WITHOUT a
  193.             specific number, PaperBack! will use a default of 66 lines per
  194.             formfeed. If you know that the source textfile contains valid
  195.             (pre-existing) formfeeds, and you would like to use these
  196.             pre-existing formfeeds, then you shouldn't use the "-F" switch.
  197.             Any use of the "-F" switch will cause PaperBack! to override the
  198.             existing formfeed settings for that document. Some examples:
  199.  
  200.               Example: PaperBack! -s -f45 -ivd0:doc
  201.             will summarise the contents of "vd0:doc" by using a formfeed
  202.             setting of one formfeed per 45 lines of text. No actions will be
  203.             taken by PaperBack! as summary mode is passive.
  204.  
  205.               Example: PaperBack! -f80 -ivd0:doc
  206.             will output the contents of the textfile "vd0:doc" using a
  207.             formfeed setting of one formfeed for every 80 lines of text.
  208.  
  209.               Example: PaperBack! -f -ivd0:doc
  210.             will output the contents of the textfile "vd0:doc" using a
  211.             default formfeed setting of one formfeed for every 66 lines of
  212.             text.
  213.  
  214. -iinfile  - this switch tells PaperBack! which file to load and use as it's
  215.             source file. Please note that the entire path to a file MUST be
  216.             given.
  217.               Example: PaperBack! -s -idh0:devs/mountlist
  218.             will summarise the contents of the file "dh0:devs/mountlist".
  219.  
  220. -ooutfile - this switch tells PaperBack! the base name of the output files.
  221.             By default, when you ask PaperBack! to actively edit a document,
  222.             whether using the document's built-in formfeed settings or using
  223.             your override settings, PaperBack! will need to output two
  224.             files. The first output file will be the ODDS files. This is
  225.             the file which contains all of the odd-nunbered pages from the
  226.             source document. The second file is the EVNS (evens) file. This
  227.             file contains the even-numbered pages from the source document.
  228.             Each of these files must have a valid name. This switch allows
  229.             you to set the basename of each of these files. If you don't
  230.             use this switch, then PaperBack! will default it's output names
  231.             using this formula: ODDS = inputname.ODDS
  232.                                 EVNS = inputname.EVNS
  233.             If you were to use this switch in this way:
  234.  
  235.               Example: PaperBack! -ivd0:doc -oram:doccy
  236.             you would receive your two output files in the ram: directory,
  237.             named "doccy.odds" and "doccy.evns" for odds and evens
  238.             respectively. If you were to NOT use the "-O" switch:
  239.  
  240.               Example: PaperBack! -ivd0:doc
  241.             you would receive your two output files, named "vd0:doc.odds"
  242.             and "vd0:doc.evns". When the "-O" switch isn't given, PaperBack!
  243.             defaults to using the source filename, and appends the ".odds"
  244.             and ".evns" suffixes to this source filename.
  245.  
  246.  
  247. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  248.  
  249.                                  So What?
  250.                                  --------
  251.  
  252.     Well, once you have rendered your original document into it's two
  253. constituent "odds" and "evens" parts, you can then print the files using
  254. whatever editor/printing utility that you like. What I usually do is this:
  255. 1. I PaperBack! -s the document I intend to print.
  256. 2. I then notice how many odd sheets I'll need (checking the information
  257.    that PaperBack! has printed to the CLI window for me!)
  258. 3. I arrange that many sheets of paper and set up the printer.
  259. 4. I print the odd sheets.
  260. 5. I turn the sheets upside down, and sort them back to front.
  261. 6. I arrange the sheets of paper back into the sheet feeder.
  262. 7. I print the even sheets on the backs of the odd sheets.
  263.  
  264.     It might sound like a pain in the arse, but it sure beats using twice
  265. the amount of paper. On a test document (which I needed to print out
  266. anyway!), without PaperBack! the hardcopy would have taken 84 sheets pf
  267. paper. Using PaperBack!, I only used 42 sheets. AND it's better for the
  268. environment!
  269.  
  270.      BTW, I've never tried PaperBack!  with continuous feed paper, but I
  271. cannot see why it couldn't be done.  After all, formfeeds still work ok in
  272. tractor mode!
  273.  
  274. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  275.  
  276.         If this program works well, or if it fills a gap in your software
  277. collection, then also feel free to contact me and we'll talk.  I love my
  278. fiance, KickOff 2, Kelly Bundy and bikini-clad babes. If you feel like
  279. talking electronically or snail-mail-wise about any of these issues
  280. (although Kim might have something to say about that! *;-), please do so.
  281.  
  282.  
  283. Contact addresses!
  284. ------------------
  285.  
  286. Snail:
  287.         Bob Rye
  288.         11 Beaver Street
  289.         St. Albans
  290.         Victoria
  291.         Australia 3021
  292.  
  293. Electronic:
  294.         Bob_Rye@guru.apana.org.au (preferred!)
  295.         3:633/359.7@fido          (preferred!)
  296.         41:300/359.7@amiganet
  297.         42:8699/8.7@trinet
  298.         bobrye@csource.oz.au
  299.  
  300. CRAZY DIAMOND 3:633/359@fido
  301. Phone: [Intl. +61 3 5698873] [National 03 5698873] up to 14.4k
  302. SysOp: Chris Quonoey
  303.  
  304. The latest PUBLIC version of all of my programs will always be available on
  305. this BBS.
  306.  
  307.